= ["Using Finch"] =

[[TOC(inline,noheading)]]

== Getting around ==
=== How do I switch between windows? ===
You can press {{{alt-n}}}/{{{alt-p}}} to go to the next/previous window. You can also press {{{alt-w}}} to bring out a list of all the windows. In the window list, you can select a row and press return to go to that window.

=== How can I close a window? ===
Press {{{alt-c}}}.

=== How can I show the menu to a window? ===
The default key-binding is to press F10. Note that not all windows has a menu.

=== How can I pop up the context menu to a widget? ===
The default key-binding is to press F11.

=== How can I enable the mouse? ===
In {{{~/.gntrc}}}, set {{{mouse = 1}}} under {{{[general]}}}.

=== My arrow keys are not working. What can I do? ===
Make sure there is a correct terminfo setting for your terminal. For example, try setting $TERM to "screen" instead of "screen.linux".

=== How do I see the parts of a large window that fall below the screen? ===
Press alt+ctrl+j to scroll down, and alt+ctrl+k to scroll up.

== Buddy List ==
=== How can I add a buddy, or a chat, or a group? ===
 * Select a group in the buddylist.
 * Press F11 to bring out the context menu. Select "Add Buddy" or "Add Chat".

=== How can I auto-join a chat? ===
 * Select the chat in the buddylist.
 * Bring out the context menu. Select 'Auto-join'.

=== How can I move buddies/chats into another group? ===
 * Select the buddy/chat you want to move in the buddylist.
 * Press 't' to tag the buddy/chat. You can tag more than one buddy/chat at the same time if you want.
 * Select the buddy/group you want to move the tagged buddies to.
 * Press 'a' to attach. The buddies will be attached to the selected contact. The chats will be attached to the current group.

=== How can I show offline buddies? ===
 * In the buddylist, press F10 to bring up the menu.
 * Select 'Options' | 'Toggle offline buddies'

=== I closed the buddylist. Can I get it back again? ===
Yes! Press {{{alt-a}}} to bring out the actions menu, select 'Buddy List'.

== Conversations ==
=== In chats, can I see the list of users in the chatroom? ===
Yes. Use the {{{/users}}} command. (after 2.0.0. Until then, press tab and all the users will be presented in the tab-completion dropdown)

=== In a conversation with a contact, can I select which buddy the message is sent to? ===
Yes. Bring out the menu for the conversation window. Select the buddy from the 'Send To' menu. (after 2.0.0)

== Others ==
=== Is there a pounce/debug/file-transfer/preference/plugins/status window? ===
Yes! Press {{{alt-a}}} to bring out the actions menu. Select the window you want to see.

=== How do I get the mouse working in screen? ===
You can do a bunch of things with the mouse in finch (after putting "mouse = 1" in ~/.gntrc), including selecting text over multiple lines in conversation windows, which is hard to do with the mouse selection in your terminal - so having the mouse enabled in finch can be advantageous. For at least a few people, screen is missing the kmous capability entry in its terminfo. Here's how to add it:

From the terminal in which you run screen, and while not in screen:
{{{
#!sh
infocmp | sed -n 's/.*\(kmous=[^,]\+\).*/\1/p'
}}}
(from what I've read, for this to work in ncurses, the value "must" be "\E[M"?)
Within screen:
{{{
#!sh
infocmp > tmp
}}}
Open tmp and add the kmous entry from above, save and close and do:
{{{
#!sh
tic tmp
}}}
When the mouse is enabled, hold shift to use your terminal's mouse selecting.

=== In screen, when I press esc, there is a huge delay, how can this be reduced? ===
Finch adds its own small delay after pressing esc, to allow pressing esc then <whatever> in quick succession for alt-X shortcuts where your alt key may be missing. Screen also does this, so to avoid having both applications add the delay:
maptimeout 0
into ~/.screenrc
Alternatively, type C-a :maptimeout 0 while in screen.